Java wrappers for Address Object on AIX

************
INTRODUCTION
************

This file describes how to set up and use the java wrapper code with Melissa DATA's Address Object.


*************
PREREQUISITES
*************

To make use of the Address Object java wrapper you will need:

* An installation of a Java Developer's Kit 1.4.2 or later or an equivalent product.

* The Melissa DATA Address Object library and data files installed.
  These files are installed automatically if you run setup.sh. 

You will need to know the location of these items in order to install and run the java wrapper.


*************
Installation
*************

Copy the entire folder that contains this readme.txt into a local directory on your computer.


*****
Setup
*****

Open BuildWrapper.sh. Put the path of the installed Address Object library files into mdAddrPath.
Then, put the path of the include directory from your Java JDK.
	
	ex: mdAddrPath=/dqt/address/solaris/xlc6_32bit
	JavaIncludeDirectory1=/usr/java/include

BuildWrapper.sh has compile commands for both the gcc33_32bit and the xlc6_32bit verions of libmdAddr.so. Select the compiler you are using and comment out the other version. 
 
*****NOTE*****
Using the GCC version of libmdAddr.so, you must make a copy of libmdAddr.so and name it libmdAddr.a. This is because GCC on aix cannot link to .so files but only .a while shared libraries can have an .a extension.

Open RunSample.sh. Put the path of the directory containing libmdAddr.so into AddrLibraryPath.

	ex: AddrLibraryPath=/dqt/address/solaris/xlc6_32bit

Also, set the Address Object License string that you receive from your Melissa Data sales representative as 
well as the directory of the Address Object data files in the sample java code AddressSample.java.
	ex: LicenseString="LICENSE"
	DataPath="/DQT/Current"


*******************
Running the Scripts
*******************

1. Execute BuildWrapper.sh (sh BuildWrapper.sh). This should create a file name libmdAddrJavaWrapper.so and mdAddr.jar. These files must be created successfully to proceed.

2. Execute RunSample.sh (sh RunSample.sh). This will compile AddressSample.java and ParseZipStreetSample.java. Only AddressSample.java will be run. To run ParseZipStreetSample, you can change RunSample.sh.


***********
Sample Code
***********

AddressSample.java contains sample code for using Address Object.
If you make changes to AddressSample.java, you must execute RunSample.sh again to recompile the code.

Now you can build your program, set your environment variables and command lines 
(using the shell scripts as a guideline) and you're ready to go.

*******
Updates
*******

libmdAddrJavaWrapper.so and mdAddr.jar build by BuildWrapper.sh do not need to be re-built for every single update. For normal updates, simply replacing libmdAddr.so and the data files are enough. However, if there is a change in libmdAddr.so like a new method, you will need to rebuild the wrapper to use the new method. 

COPYRIGHT NOTICE

(C) 2010 Melissa Data Corporation. All rights reserved.
